home *** CD-ROM | disk | FTP | other *** search
/ Freaks Macintosh Archive / Freaks Macintosh Archive.bin / Freaks Macintosh Archives / Macintosh / Tex_Edit_Plus-2.3.3.sit / TE+ 2.3.3 / Welcome to Tex-Edit! < prev    next >
Text File  |  1998-08-04  |  72KB  |  813 lines

  1.  
  2.      
  3.  
  4. Welcome to Tex-Edit Plus, my scriptable, styled text editor that fills the gap between Apple’s bare-bones SimpleText and a full-featured word processor!  It is particularly useful for formatting text that is transmitted over the Internet.  Tex-Edit Plus is small, fast, easy-to-use and requires little memory.  Tex-Edit Plus is Shareware ($10).
  5.  
  6. With Tex-Edit Plus you can:
  7. •  Quickly create, edit and print styled text documents of any size (limited by RAM).
  8. •  View and print TeachText or SimpleText read-only (“ReadMe”) documents.
  9. •  Easily create TeachText/SimpleText read-only documents, including embedded pictures.
  10. •  View and print color PICT files, such as those produced by draw programs or
  11.     Apple’s built-in screen snapshot utility.
  12. •  Copy a selection from a PICT file, cropping the image for use in the company newsletter.
  13. •  View, edit and print text documents created by virtually any word processor or computer.
  14. •  Reformat downloaded e-mail or text, correcting word-wrap problems and removing
  15.     extraneous, non-Mac characters.
  16. •  Prepare text for upload to the Internet, so that people with Wintel or UNIX systems can
  17.     view the document as it was intended to be viewed.
  18. •  Instantly quote a brief passage from received e-mail, allowing the sender to remember
  19.     their original message.
  20. •  Explore the power of AppleScript.
  21. •  Read any text document aloud, if you have Apple’s Speech Manager extension.  (Listen
  22.     to a SimpleText read-only file, for example, as the text and pictures scroll by!)
  23. •  Quickly optimize a document for printing, replacing generic, typewriter-era characters 
  24.     with professional-looking typographically correct text.
  25. •  Create simple hypertext documents.
  26. •  Insert attention-getting sound annotations to spice up ordinary inter-office mail.
  27. •  And more…
  28.  
  29.   Tex-Edit Plus is a MUT 1996 Shareware Awards winner.  For further information, please check out:  <http://members.aol.com/macutility/mut_awards.html>
  30.  
  31.   Tex-Edit Plus is a winner of the MacUser 1995 Shareware Awards.  For further information, check out:  <http://www.zdnet.com/macuser/mu_1095/shareware_awards.html>
  32.  
  33.   Tex-Edit Plus is a MacWorld Editor’s Choice recipient (Best Utilities, October 1997).  For further information, check out:  <http://www.macworld.com>
  34.  
  35. [To print this document, please turn off “font substitution” in the Page Setup dialog.]
  36.  
  37.  
  38. Contents:
  39.  
  40. 
  41.  
  42.  
  43. Drag & Drop spoken here…
  44.  
  45. Do you appreciate the ease with which the Finder allows you to shuffle application, document and folder icons?  Have you mastered the System 7 trick of dropping a document onto an application icon, forcing that application to open the document?  Do you like being able to drag text selections around in Microsoft Word?  How would you like to be able to select any data in any program window and move it to any other program window as easily as you drag Word 6 to the trash?  No cutting, no copying, no pasting, no program switching, no messing with data translations…
  46.  
  47. Apple’s wonderful Drag Manager technology takes the popular Drag & Drop functionality of the Finder and extends it to its logical conclusion.  Drag & Drop is more intuitive, easier to learn and much faster than the clipboard.  The Drag Manager allows data streaming, delayed delivery of data, and simultaneous transfer of multiple items (each of which can have a different data type).  The Drag Manager also integrates with Macintosh Easy Open, providing automatic data type translation.  The new Finder can even keep track of separate “clipping” files, providing the functionality of a multi-layer clipboard.
  48.  
  49. Drag & Drop is easily demonstrated using Tex-Edit Plus.  First open or create a few short Tex-Edit documents and arrange the windows so they don’t totally hide one another.  (See Figure 1.)  Select (hilite) a word, then move the cursor over the selection.  Notice how the I-beam turns into an arrow when over a selected block of text.  This signifies that the selection is “draggable.”  Now click and drag the selection.  A gray outline of the selection will follow your cursor as it moves over the window.  A blinking vertical “insertion marker” is visible at the tip of the arrow, indicating the target location.  Release the button while still in the same window.  Instantly, the original selection disappears and then reappears at its new location.  Notice how inter-word spacing is preserved at the origin and destination sites (similar to “smart” cut and paste).
  50.  
  51. 
  52.  
  53.      Figure 1.  A “gray” selection outline follows the cursor.  Note the flashing insertion point.
  54.  
  55. Since the dragged text is still selected, try dragging it to another Tex-Edit Plus window.  When the cursor enters the new window, notice how the text area of the window “lights up.”  (See Figure 2.)  This signifies that the window is capable of receiving all of the items being dragged.  Release the mouse button.  An exact copy of the text now appears in the new window at the point it was dropped.  Although the recipient window does not become active (come to the front), you can still tell where the text went, because background text selections are outlined.
  56.  
  57. 
  58.  
  59.      Figure 2.  The destination window “lights up” if it can accept the dragged items.
  60.  
  61. As a matter of fact, you can now click on the outlined text in the inactive window and drag it to one of the other windows, copying the selection without having to activate either window!  (Try it.)  Now go back to the front-most (active) window and drag the text selection within the same window while holding down the option key.  Notice that this results in a copy operation instead of a move (just like in the Finder).  Drag the text selection to the top or bottom of the active window and notice that it will “auto-scroll” to reveal the rest of the document.
  62.  
  63. The real fun starts for System 7.5 (and System 7 Pro) users when the text selection is dragged to the desktop.  A text “clipping” will appear at the drop point.  (See Figure 3.)  Double click the clipping file to see its contents.  Drag it back into any drag-savvy application window when you wish to use it.  You can even drag multiple clippings simultaneously.  (They are inserted into the text in the order in which they were selected in the Finder.)  I keep a “return address” clipping on the desktop and drag it to the top of all my correspondence.  It’s much faster than the scrapbook!
  64.  
  65. 
  66.  
  67.      Figure 3.  Drag a selection to the desktop to create a “clipping” file for later use.
  68.  
  69. Now sit back and experiment to your heart’s content.  Try to figure out how and why windows become active during all this moving and copying.  (It really is quite logical.)  Try dragging a selection onto the menubar.  If you happen to drop data on an area that cannot accept that particular data (such as this read-only document window), notice how the selection “zooms” back to its starting point.  Try clicking in the middle of a selection.  Try dragging a text document from the desktop to an open Tex-Edit window.  Guess what happens when you drag a selection onto the Trash.  If you have System 7.5.x (not 7.5.1) and want a real surprise, select these three words: secret about box and drag the selection to the desktop!
  70.  
  71. By now you’re probably thinking, “Golly this is neat.  I just wish I could drag pictures around that easily!”  Well, wish no more.  Tex-Edit Plus allows you to drag pictures and sounds as easily as text.  In fact, you can even drag combinations of various items.  Life is good.
  72.  
  73. Drag & Drop is a wonderful technology that Apple has seamlessly integrated into System 7.5 and later.  It is also available to the users of 7.0, 7.1, 7.1.1 (Pro) and 7.1.2 through the magic of the Macintosh Drag and Drop extension file.  System 7.1.1 and 7.1.2 users can use the Clipping extension to allow the Finder to create clipping files.  Inter-application dragging on System 7.1 requires an additional extension (the Dragging Enabler file).
  74.  
  75. Unfortunately, not all programs use the Drag Manager.  Undoubtedly, more and more applications will become Drag Manager-aware as Mac users discover the power of this new technology and demand its addition to their favorite programs.  Developers who ignore advanced features of the Mac operating system in an effort to maintain “cross-platform uniformity” do not deserve our support…
  76.  
  77.  
  78.  
  79. MS-DOS versus the Mac…
  80.  
  81. You may have noticed that your e-mail sometimes has funny little boxes at the beginning of each line.  This problem arises because MS-DOS/Windows and the Mac have different opinions about line endings.
  82.  
  83. MS-DOS editors commonly use a character-based line width.  When the cursor gets to the last (usually 80th) character position, the editor obligingly backs up to the beginning of the word being typed, inserts a CR (carriage return) and LF (linefeed character) and then carries the unfinished word down to the next line.  This prevents lines from extending past the right margin and also prevents words from being split between lines.  In a similar manner, most generic BBSs terminate each line with a single CR.
  84.  
  85. In the Mac world, text editors dynamically “word-wrap” at the right margin and do not insert any special characters until the end of the paragraph, at which point they insert a single carriage return.  (See Figure 4.)  When viewing a non-Mac file, therefore, the Mac user may note that each line is preceded by an empty box (signifying the terminating LF character from the preceding line).  In a large window, the text may not extend to the right margin, and in a small window, there is usually an odd mixture of alternating short and long lines.  The Mac thinks each line is a separate paragraph!
  86.  
  87. 
  88.  
  89.      Figure 4.  This looks like a job for the “Strip CR/LF” command (in the Modify dialog)!
  90.  
  91. You may have also noticed strange squiggles and misspelled words scattered throughout your downloaded text.  (See Figure 5.)  This is because the Mac and MS-DOS have different ideas about the use of the “upper” ASCII range.  (ASCII is a standard convention used to define how all computers store alphanumeric characters.)
  92.  
  93. Unfortunately, the ASCII convention only specifies values for the first 128 (out of 256) characters.  The Mac uses the remaining upper range of characters to hold diacritical markings, foreign characters, typographical (curly) quotes and a host of other goodies not found on a standard typewriter.  As you might guess, MS-DOS uses those upper 128 characters for a completely different set of symbols.
  94.  
  95. 
  96.  
  97.      Figure 5.  Notice what happens to curly quotes, em dashes, ligatures, ellipses, etc.
  98.  
  99. Luckily for you, Tex-Edit Plus can easily handle all of these problems using the Modify dialog (see below).
  100.  
  101.  
  102.  
  103. Tex-Edit Plus versus other Editors…
  104.  
  105. You will discover that Tex-Edit documents lose all their style attributes, pictures and sounds when opened by other word processors (and vice versa).  This is because most word processors use their own private method for storing character styles (font, size, color) as well as non-text embellishments.
  106.  
  107. Tex-Edit Plus can swap styled documents with America Online, Joliwrite, SimpleText and Stylus, since they all store style information in the same way.  You have to rely on the clipboard (or Drag & Drop) to swap styled text with most other word processors.  Curiously, at least one expensive word processor does not support Apple’s standard clipboard format for styled text.  Go figure…
  108.  
  109.  
  110.  
  111. Apple Menu
  112.  
  113. About Tex-Edit Plus…
  114. This displays the identifying number and release date of this version of Tex-Edit Plus.  This information is useful when obtaining product support.  The Help button activates the Help dialog which contains some interesting information, tips, tricks and shortcuts.  Use the popup menu to navigate between the various topics.
  115.  
  116.  
  117.  
  118. File Menu
  119.  
  120. New
  121. This opens a new blank document window.  Up to 40 windows can be open simultaneously, depending on Tex-Edit’s memory allocation.  To increase Tex-Edit’s memory allocation, enter a new “preferred size” in the Finder’s Get Info dialog box.  You will need to add about 40K per extra window.
  122.  
  123. Open…/Open Any…
  124. Use this command to pick the TEXT or PICT document you wish to open.
  125.  
  126.      
  127.  
  128.      Figure 6.  Holding down the option key lets you open anything!
  129.  
  130. If you wish to view a non-TEXT document, such as a Normal Word document, hold down the option key when choosing this command.  (Technically, Tex-Edit Plus only opens the “data fork” of the chosen file.)  You may notice some strange characters embedded in the text.  (For example: “442Real Mac users do it with Tex-Edit”)  These proprietary formatting characters are used by the parent program.
  131.  
  132. Have you forgotten the name of the file you’re looking for?  Save time by using the “Show Preview” button to display the first few lines of each text file (or a miniature representation of the chosen picture file).  This feature requires installation of the QuickTime extension.
  133.  
  134. Open Selection…
  135. Want to be able to move quickly between related documents?  You can create simple hypertext networks, using the main (root) Tex-Edit Plus document as a jumping-off point for a whole group of related documents.  Select the word of interest and choose Open Selection to activate the “hyperlinked” document.  (To demonstrate, try opening this document: Revision History.)
  136.  
  137. 
  138.  
  139.      Figure 7.  If the word “song” is selected, then Open Selection will play the song file.
  140.  
  141. The desired document (or its alias) must reside in the same folder as the root document.  If the selected file cannot be found, Tex-Edit Plus will beep and display a standard Open dialog.  If the selected file exists and is not a TEXT, PICT or SimpleText document, Tex-Edit Plus will open the document by launching its creator application.  For example, if the desired document is an Excel spreadsheet, Tex-Edit Plus will launch Excel and Excel will display the spreadsheet.
  142.  
  143. Insert…/Insert Any…
  144. Use this command to insert a bit of text from another document.  The text from the chosen donor document is inserted into the active document at the cursor position, replacing any text that may be selected.  The donor document is not affected.  If you hold down the option key before choosing this command, you will be allowed to insert text from any file, including non-TEXT files.
  145.  
  146. Close/Close All
  147. This closes the active window.  You will be prompted to save any changes you may have made.  If you hold down the option key, all document windows will be closed rapidly.  Likewise, holding down the option key while clicking in the close box will close all windows rapidly.
  148.  
  149. Save/Save All
  150. This saves any changes you have made to the file in the active window.  Tex-Edit Plus displays a standard Save As dialog if the document has not yet been saved to disk.  Holding down the option key will allow you to quickly save all open documents.
  151.  
  152. Save As…
  153. This brings up the standard dialog for creation of a new text file on your disk.  The File type pop-up menu allows you to choose the desired file format.  Tex-Edit Normal is the default styled Tex-Edit Plus format.  Tex-Edit Plain Text will create a Tex-Edit Plus document without any style information, thus saving a small amount of disk space (about 20%).  Tex-Edit Read Only will create a styled document that can be viewed, read aloud, printed and copied from but not altered.  (This is useful if you want a “ReadMe” file to remain unaltered.)
  154.  
  155.      
  156.  
  157.      Figure 8.  An oddly-titled document is about to be saved in WordPerfect format.
  158.  
  159. If you want to create a stationery pad boiler-plate, use the Stationery button.  The Stationery button does not affect the file’s creator or format and can be used with any text file type.  A stationery pad document will always open as “untitled,” so changes do not affect the parent template.
  160.  
  161. Tex-Edit Plus can also directly create Word, Word Perfect, MacWrite, WriteNow, SimpleText and America Online documents (as well as a few others).  To create another type of document, select the Other option.  This displays a dialog box that allows you to enter any 4-character creator code.
  162.  
  163. Tex-Edit Normal and Tex-Edit Read Only documents remember their size and screen position when saved.  They will appear in the same place when reopened, if you have selected Documents remember size and position in the Preferences dialog.
  164.  
  165. A Sound file is a double-clickable System 7 sound document that can be placed in the System to be used as an alert sound, etc.  Tex-Edit Plus can create such a file if you have used the Record Sound or Insert Sound command to insert a sound into the current document.  The first sound in the document is used to create the new sound file.  Likewise, use the PICT file type to create a normal picture file containing the first picture in your document.  Saving as a sound or pict does not affect your original document in any way.
  166.  
  167. Revert
  168. Did you make a mistake that even Undo can’t correct?  This command will restore the last saved version of the active document.  All changes made since the last time the file was saved will be lost.
  169.  
  170. Page Setup
  171. Use the Page Setup dialog to adjust the appearance and layout of the printed page.  The top portion of the dialog is printer-specific.  (Use the Chooser to select the desired printer.)  Tex-Edit adds a few special options to the bottom portion of the dialog.
  172.  
  173. Adjust the white space surrounding the printed text by entering the desired margin widths (in inches or centimeters, depending on the Preferences dialog).  If the margins are set to zero, then your printer’s maximum printable area will be used.  (The maximum printable area can sometimes be increased by selecting “Larger Print Area” in the Page Setup/Options dialog.)
  174.  
  175. 
  176.  
  177.      Figure 9.  Here, each page will have a 1 inch margin, be single-spaced, and numbered.
  178.  
  179. The “Double spaced” option creates double spaced printouts and the “Pages numbered” option prints a page number at the bottom of each page.
  180.  
  181. Each document has its own page setup settings.  These settings are saved with the document.  Choose “Save settings as defaults” to use the current margin, spacing and numbering settings as the default settings in new documents.
  182.  
  183. Tip: to avoid misaligned indents in printouts, leave “Font Substitution” off.
  184.  
  185. Print…/Print Selection…
  186. This displays the standard Print dialog for the printer you have selected in the Chooser, allowing you to print the current document.  Hold down the option key to print just the selected text.
  187.  
  188. Want to print front and back?  Tex-Edit adds the option to print just the odd or even numbered pages.  (First, print “odd only.”  Next, turn the printed pages over and reinsert them into the printer.  Finally, print “even only.”)
  189.  
  190. Print One Copy
  191. Need to spit out a printed copy of the active document fast?  This command sends a print command directly to your printer, bypassing the standard Print dialog.
  192.  
  193. Quit
  194. This closes the Tex-Edit Plus application.  You will be prompted to save any altered or unsaved documents before Tex-Edit Plus quits.
  195.  
  196.  
  197.  
  198. Edit Menu
  199.  
  200. Undo
  201. This reverses your most recent editing action or style change.  After you undo something, it can usually be redone if desired.
  202.  
  203. Cut
  204. This removes the current selection to the clipboard, making it available for pasting into other locations or other documents.  The clipboard holds the text as well as its “styl” information, making styled selections available to other programs.
  205.  
  206. Copy
  207. This makes a copy of the current text/sound/picture selection and places it in the clipboard.
  208.  
  209. Paste
  210. This moves a copy of the text/sound/picture in the clipboard to the current insertion point, deleting anything that may be selected.  If you hold down the option key, only plain text will be pasted.
  211.  
  212. Clear
  213. This erases the current selection.
  214.  
  215. Copy Unstyled
  216. Sometimes it is convenient to move plain text (without any associated attributes, such as font, size or style).  This command copies the plain, unstyled text to the clipboard.
  217.  
  218. Paste Unstyled
  219. This command moves the clipboard’s text to the current insertion point, ignoring styles.
  220.  
  221. Select All
  222. This hilites (selects) the entire document.  If a PICT document is active, then the entire picture is enclosed in the selection marquee.
  223.  
  224. Insert Date
  225. The current date is pasted at the insertion point.
  226.  
  227. Insert Time
  228. The current time is pasted at the insertion point.  The clipboard is not affected.  Use the “Date and Time” control panel (System 7.1+) to alter the format of the date and time.
  229.  
  230. Insert Page Break
  231. If you want to make sure that chapter headings always appear at the top of the page, use this command to insert a formfeed character.  All subsequent text will print starting at the top of a new page.  The formfeed character shows up as a little non-printing box.
  232.  
  233. Preferences…
  234. Do you like to use 18 point Times, save all your documents in Word format and use curly quotes?  The Preferences dialog allows you to preset many of these features and store your preferred settings in a “Prefs” file in the Preferences folder.
  235.  
  236.      
  237.  
  238.      Figure 10.  Easily customize many of Tex-Edit’s features.
  239.  
  240. The Preferences dialog has multiple “panels” which consist of logically-grouped options.  Use the popup menu at the top of the dialog to select the desired panel.  The Reset button will revert all settings in all panels to their factory default values.
  241.  
  242.      Global Options:
  243.  
  244.      1) Display splash screen at startup.  If you wish to maximize launch speed and avoid seeing the beautiful Tex-Edit startup picture, turn this option off.
  245.  
  246.      2) Use temporary (system) memory.  Are you running into some unwanted “out of memory” messages when working with large documents?  If this option is selected, Tex-Edit will attempt to use unallocated system memory instead of its own memory block (which is adjusted by choosing “Get Info” in the Finder).  In most circumstances, this allows you to manipulate larger documents and also frees memory for other applications.
  247.  
  248.      3) Offscreen (flicker-free) drawing.  Do you ever notice a “flickering” effect as typed characters appear on the screen?  Use this option to allow characters to be formed offscreen before they are moved smoothly into the text.
  249.  
  250.      4) Enable Text Services Manager at startup.  Some non-Roman script systems make use of “inline input” to enter multi-byte characters directly into the text.  To enable inline input the next time Tex-Edit Plus is launched, turn this option on.
  251.  
  252.      5) Enable WYSIWYG Font menu at startup.  So, is Arial a serif or a sans-serif?  Use this option to enable a WYSIWYG Font menu with embedded type specimens.  (Requires OS 8 or newer.)
  253.  
  254.      6) Startup action:___  This pop-up menu allows you to specify how Tex-Edit Plus behaves when first launched.  If you normally like to create new documents from scratch, choose Show Blank Document.  If you spend most of your time editing preexisting documents, then choose Show “Open…” Dialog.  If you like having Tex-Edit Plus instantly available for text editing chores (and who doesn’t), use the Nothing option and place an alias of Tex-Edit Plus in the Startup Items folder (in the System folder).
  255.  
  256. Do you always start the day with four precisely-positioned, pre-formatted windows?  Consider using the Run “Startup” Script option.  If you place a script named “Startup” in the Scripts folder, it will run automatically whenever Tex-Edit is launched.
  257.  
  258.      7) Measurement:  Choose your preferred unit of measurement, inches or centimeters.  This choice is used in the Page Setup dialog (margins).
  259.  
  260.      Document Options:
  261.  
  262.      1) Play first sound when document opens.  If this is selected, Tex-Edit Plus will automatically play the first sound object embedded in each document as it is opened.  Sounds can be attached to documents using the Record Sound or Insert Sound commands in the Sound menu.
  263.  
  264.      2) Default justification.  This popup menu specifies the text alignment used by generic documents and new blank windows.  Normal Tex-Edit documents remember their previous alignment setting.  Note that “real tabs” will only work when the text is left-aligned.
  265.  
  266.      3) Default window size:___  This pop-up menu allows you to set the size of new windows.  Full Screen windows will attempt to fill your main screen.  (Note that the window cannot be wider than the “text wrapping width” setting described below.)  The Custom (Top Window) option will make the default window size the same as the document window you are currently viewing.  The Small, Medium and Large options match the size of the corresponding “text wrapping width” options (below).
  267.  
  268.      4) Text wrapping width:___  To allow your text to automatically word-wrap to fit between the left and right sides of the window (like SimpleText), select Soft Wrap.  This deactivates the horizontal scrollbar and may cause a delay when resizing windows containing a large amount of text.
  269.  
  270. If you always view BBS text of a given line width, several handy presets are available, allowing you to set the line width to exactly 60, 80 and 100 characters (if you are using 9 point Monaco).  If you are writing source code and want each entry to stay on a separate line, select the Wide Open option.  The Page Setup Size option will wrap the text to the page width specified in the Page Setup dialog, giving you a better idea how the printout will look.  These options do not affect the document’s data, only the screen display.
  271.  
  272.      5) Size/Font:___  These pop-up menus allow you to change Tex-Edit’s default font and font size.  The default font and size are used when a new window is created or when a generic unstyled text file is opened.
  273.  
  274.      Edit Options:
  275.  
  276.      1) Shift-delete mimics forward delete key.  If you don’t have an Extended Keyboard, but need the functionality of the forward delete key, check this box.  Shift-delete will then delete the character following the insertion point, rather than the character preceding the insertion point.
  277.  
  278.      2) Smart cut, paste and delete.  In most cases, this option will save two keystrokes in the cut-and-paste cycle.  Cutting a word from the middle of a sentence will leave only a single space, which is usually what you want.  If you subsequently paste the word between two other words, Tex-Edit Plus will place a single space between each of the words.  Likewise, the delete and forward delete keys will remove the selected word(s) as well as the extra space, saving one keystroke.
  279.  
  280.      3) Smart (“”) quotes.  If this is selected, typographically superior (“curly”) quotes will automatically be used whenever you hit the single or double quote key.  You may wish to disable this feature if you are creating files to be sent to non-Mac systems, since they won’t be able to recognize these characters.
  281.  
  282.      4) Quote Characters…  Different languages use different characters to signify "plain" and “smart” quote characters.  Luckily, you can customize Tex-Edit’s opinion of what constitutes a plain or smart quote.  The desired substitutions are used whenever the Smart Quotes option is active, or when invoking the Smarten or Stupefy Quotes commands.
  283.  
  284.      Save Options:
  285.  
  286.      1) Change document “creator” to:___  If you want Tex-Edit Plus to save documents so that another word processor (e.g., Word) will open when the document is double-clicked, check this option and enter the appropriate 4 character creator code.  (For example, Word’s creator is MSWD.)  The Finder uses this code to identify the document’s parent application and icon.
  287.  
  288. If you wish to save files as Tex-Edit Plus documents, check this option and use TBB6 (Tex-Edit’s creator code).  To open, edit and save a file without changing its parent application or icon, leave this option off.
  289.  
  290.      2) Documents remember size and position.  If this is selected, Tex-Edit Plus will restore a document’s previous size and screen position when it is reopened.  This only works with Tex-Edit Normal and Tex-Edit Read Only documents.  If this option is off, document windows will be evenly “staggered” as they are opened.
  291.  
  292.      3) Documents remember text selection.  This option makes it easy to start up again where you left off.  When a document is reopened, the cursor will be at the same place it was when you last saved the document.  This only works with Tex-Edit Normal documents.  If this option is off, the cursor will always reappear at the beginning of the document.
  293.  
  294.      4) Auto-save every ___ minutes.  Ever spend an hour of diligent typing, only to have a helpful coworker trip over your power cord?  This option will execute a “Save All” at whatever time interval (1-99 minutes) you select.  This command is surprisingly unobtrusive and is highly recommended.  If you never write anything of importance, please turn this option off.
  295.  
  296.      Tab/Block/Print/Speech Options:
  297.  
  298.      These preference panels are discussed individually in the Style Menu, Special Menu, File Menu and Sound menu sections respectively.
  299.  
  300.  
  301.  
  302. Special Menu
  303.  
  304. Find/Replace…
  305. Suppose you wish to quickly locate a specific name in a long text document?  Or, you want to update a document by replacing all instances of the year “1997” with the current year?  The Find/Replace dialog allows you to locate any given text string and optionally specify a replacement string.
  306.  
  307. The Find button hilites the first occurrence of the desired string.  (You may then use the Find Next or Replace & Find Again menu commands.)  The Replace All button replaces all occurrences of the find string with the replacement string, then reports how many replacements were made.
  308.  
  309. 
  310.  
  311.      Figure 11.  Some commonly used, non-printing characters are displayed.
  312.  
  313. Perhaps you want to search for non-printing characters in order to manually clean up a passage of downloaded text.  The small buttons labeled CR (carriage return), Tab, FF (formfeed/page break) and LF (linefeed) give you easy access to four commonly encountered invisible characters.  (You may use the double caret ^^ to signify a single caret.)  Use the convenient ASCII popup menu to enter any printable character (except ASCII 0 or 1) into your find or replace strings.
  314.  
  315. Or, maybe you want to “dress up” your document by making the first character of each paragraph 14 point Horstcaps.  Change your mind and want to try 18 point Old English green?  Luckily, Tex-Edit Plus offers a wildcard search character (the “Wild” button) as well as sophisticated tools for text style manipulation.
  316.  
  317. All searches start at the top of the document, unless you select the Start search at cursor position option.  The Cases must match option forces Tex-Edit Plus to look for exact matches.  Turn this switch off if you wish case to be ignored.  (To properly find and replace words with foreign language characters/diacriticals, you must leave this switch on.)  The Whole words only option limits matches to distinct whole words (i.e., looking for “the” will find “the” but not “them” or “mother”).
  318.  
  319. Need to look for the same string in all your documents at once?  How about quickly changing your name in every open document?  If Search all windows is selected, the Find and Replace All commands will affect all open documents.  All switch settings are saved between Tex-Edit Plus sessions.
  320.  
  321. Both the find and replace text boxes have corresponding style popmenus.  These popmenus allow you to independently set various style attributes.  Entering “eagle” in the find text box and then choosing bold from the popmenu will “match” instances of the word “eagle” that are boldfaced (regardless of its font, fontsize and color).  In a similar manner, the popmenu associated with the replace text will superimpose the chosen style(s) on the replacement text.
  322.  
  323. The Wild button inserts a placeholder (^?) into either the find or the replace string.  A wildcard in the find string is ignored during the search process (i.e. the wildcard will “match” any other character, including non-printing characters).  A wildcard in the replace string instructs Tex-Edit to pass over the corresponding character in the found text selection during a replace operation.
  324.  
  325. For example, if you search for “^?athy” you will find “Cathy” as well as “Kathy”.  Likewise, you could search for “^?athy” and replace it with “^?atherine”, which would simultaneously change “Cathy” -> “Catherine” and “Kathy” -> “Katherine”.
  326.  
  327. Want to find the next URL in your document?  Use the Wild Run button to insert a placeholder (^*) for a variable (0-255) number of characters.  Searching for “<^*>” will thus find “<a.long@example.com>” as well as “<me@too.com>”.  Only the first Wild Run placeholder in the find string is recognized.
  328.  
  329. If you want to change all the URLs you just found from blue to green, use a solitary Wild Run (^*) placeholder in the replace string and set the replacement color to green.  In the replace string, the Wild Run wildcard serves as a placeholder for the entire found selection.  During the replacement, the text of the found selection replaces each Wild Run wildcard.
  330.  
  331. This table demonstrates various wildcard searches:
  332.  
  333.   Sample document text:
  334.   Time is the Enemy
  335.  
  336.   Find the text:      First match:           Comments:
  337.   ^?                  T                      Matches first character.
  338.   ^?  {italic}        E                      Matches first italic character.
  339.   ^?^?^?              Tim                    First three consecutive characters.
  340.   T^?E                the                    T and E separated by single character.
  341.   T^*E                Time                   T and E separated by multiple characters.
  342.   M^*E                me                     M and E separated by no characters.
  343.   ^*                  Time is the Enemy      Matches entire document.
  344.   ^*  {italic}        Enemy                  Matches first run of italic characters.
  345.   H^*                 he Enemy               Matches first “H” through end of doc.
  346.   ^*H                 Time is th             Matches all text up through first “H”.
  347.  
  348. This table demonstrates how a wildcard replacement operates:
  349.  
  350.   Sample document text:
  351.   Time is the enemy
  352.  
  353.   Find the text:
  354.   the
  355.  
  356.   Replace with:       Replace All result:      Comments:
  357.   ^?                  Time is t enemy          Found text replaced by first letter.
  358.   ^?^?                Time is th enemy         Replaced by first 2 letters of find str.
  359.   T^?Y^?^?            Time is ThY enemy        Superfluous trailing wildcards ignored.
  360.   ^?^?^?IR            Time is theIR enemy      First three letters of match unchanged.
  361.   ^*                  Time is the enemy        No change, but can count occurrences.
  362.   ^*  {italic}        Time is the enemy        Set style of found text to italic.
  363.   ANO^*R              Time is ANOtheR enemy
  364.   ^* ALLY OF ^*       Time is the ALLY OF the enemy
  365.  
  366. Find Again/Find Previous
  367. This command allows you to continue searching for the next match.  Hold down the option key to search backwards (for the preceding match).
  368.  
  369. Find In Next File
  370. Can’t find what you want in the active document?  Use this command to quickly search all the remaining open documents.
  371.  
  372. Replace & Find Again
  373. This replaces the hilited word with the replacement string (from the Find/Replace dialog) and continues searching for the next match.
  374.  
  375. Enter Find String/Enter Replacement String
  376. If you see a word in the document and wish to find its next occurrence, select the word and use this command to instantly copy the selection (up to 255 characters) into the Find/Replace dialog.  Then use the Find Again command.  Hold down the option key to copy the selection into the “Replace with:” field of the Find/Replace dialog.
  377.  
  378. Change Case
  379. If someone sends you a file that is ALL CAPS, select the offending text and use this command to fix it.  You can change all the selected text to uppercase, lowercase, title case or sentence case.  Title case capitalizes the first letter of each word and sentence case capitalizes the first letter of each sentence.
  380.  
  381. Block Format
  382. Quoting a brief passage from received e-mail allows the sender to remember their original message and thus the context of your reply.  This command will convert the selected text into a marked, indented block format, suitable for use in outgoing e-mail.
  383.  
  384.   > Here is a brief example of block
  385.   > formatted text with the line length set
  386.   > to 40 and block header set to “  > ”.
  387.  
  388. Block formatting may also be useful if you simply wish to emphasize a brief passage of text embedded in your document.  The number of characters per line and the indenting header characters are set in the Block Options dialog.  Notice that words are not split.
  389.  
  390. Block Options…
  391. It is often useful to dramatically hilite a block of text or an e-mail quote.  You can use this dialog to customize various attributes of the Block Format command (above).  These settings are saved in the “Prefs” file.
  392.  
  393.      
  394.  
  395.      Figure 12.  Use the Leading/Trailing line to add a distinctive flair to your reply.
  396.  
  397.      1) Leading line:___  To indicate the beginning of a new “block” in your block-formatted text, enter a few distinctive characters here.  If blank, no leading line is inserted.  Only the first 63 characters are used.
  398.  
  399.      2) Line header:___  These characters will precede each line of the block-formatted text.  You may use 0-15 characters.
  400.  
  401.      3) Length:___  Enter the maximum character width of each block-formatted line (between 20 and 200 characters per line).  Note that words will not split between lines.
  402.  
  403.      4) Trailing line:___  These characters will be inserted on the line following the block-formatted text.  If blank, no trailing line is inserted.
  404.  
  405. Quick Modify
  406. This submenu provides convenient access to several of the Modify dialog’s most useful features.  (Note that a selection from this submenu will alter the entire document, not just the selected text.)  Most of these commands are explained in the Modify Document section (below), however three commands deserve special attention:
  407.  
  408.      1) Strip LFs.  Sometimes you download a file with funny boxes in front of each line.  These boxes are actually linefeed characters that are inserted by MS-DOS systems.  (They generally follow each carriage return to signify line endings.)  Macs don’t use linefeeds.  Use this command to remove all these useless characters from the document.
  409.  
  410.      2) CRs->LFs (Mac->UNIX).  This is handy if you wish to upload a Mac file to a UNIX system.  UNIX systems use a single linefeed character (without a carriage return) to terminate each paragraph.  This command converts all carriage returns into linefeeds.
  411.  
  412.      3) LFs->CRs (UNIX->Mac).  Use this command to quickly convert a downloaded UNIX or etext file into Mac format.  All linefeeds are converted to carriage returns.  Electronic–text (etext) documents are prepared by “Project Gutenberg” of the Illinois Benedictine College.  Project Gutenberg is working to make a large number of public domain texts available as etexts.  
  413.  
  414. Modify Document…/Modify Selection…
  415. File transfers between Mac and non-Mac systems often result in frustration for users at both ends.  The non-Mac users end up with split words and run-on paragraphs, while the Mac users are greeted by a screen full of little empty boxes and oddly wrapped lines.  If you’ve ever experienced these problems, you’ve come to the right dialog!
  416.  
  417. The Modify dialog is Tex-Edit’s most complex and powerful feature.  It allows you to globally change (munge) special characters in the text.  If you only wish to modify a portion of the document, select the text of interest and choose Modify Selection.  If you don’t like the resulting modifications, be sure to choose Undo before doing anything else.  Tex-Edit Plus remembers the settings in the Modify dialog between sessions.
  418.  
  419. To convert a downloaded document to editable Mac format, first try Strip CR/LF.  If this causes all the paragraphs to “run” together, then Undo and try Replace multiple space characters with Nothing along with Strip leading spaces, Strip trailing spaces, and Strip CR/LF.  If a lot of nonsense characters are still visible, then try Strip control characters and Strip high ASCII.
  420.  
  421. 
  422.  
  423.      Figure 13.  Perform multiple, simultaneous modifications to “clean up” any file.
  424.  
  425.      1) Replace multiple space characters with:___  Some files use runs of space characters to line up columns in a table or to separate paragraphs.  This option will convert every run of two or more spaces into a Single Space (useful for normalization of word spacing), Tab (useful for tables), CR (useful if every paragraph starts with a run of spaces), or Nothing (for eliminating padding which might interfere with the Strip CR/LF command).
  426.  
  427.      2) Replace each tab with ___ space characters.  This is useful for creating tab-like text columns for use in non tab-aware programs.  If this is selected, each tab character will be replaced with the specified number of space characters.
  428.  
  429.      3) Strip control characters.  If a downloaded document contains lots of little boxes scattered through the text, this option may help.  It deletes all non-Mac control characters.  Specifically, it deletes all characters with an ASCII value less than 32 (except for tabs, carriage returns and formfeeds, which are used by Mac programs).
  430.  
  431.      4) Strip high ASCII characters.  If your downloaded text is filled with “wrong” characters and misspelled words, use this option to delete all characters in the upper ASCII range (128-256).  This option will strip many useful typographic characters (ligatures, ellipses, em dashes, curly quotes, etc.) as well as foreign language characters, so you should first convert (“stupefy”) any useful characters you wish to keep.
  432.  
  433.      5) Normalize sentence spacing.  Many people who learned to type on typewriters are still in the habit of following each sentence with two spaces.  When using proportional fonts, it is typographically preferable to separate sentences using a single space.  This option will change each instance of double space characters (following a sentence) into a single space.
  434.  
  435.      6) Strip leading spaces.  Would you like all your text to line up nicely along the left side of the window?  Use this option to remove the spaces and tabs from the beginning of each line.
  436.  
  437.      7) Strip trailing spaces.  Use this option to remove the unnecessary padding (spaces and tabs) that some editors add at the end of each line.
  438.  
  439.      8) Strip diacritical marks.  Many foreign languages use accents, umlauts, cedillas and the like.  If you wish to upload text that contains foreign characters, use this option to remove the diacritical marks from letters, converting them to their ordinary (English) equivalent.
  440.  
  441.      
  442.  
  443.      Figure 14.  Sample non-English characters and their English equivalents.
  444.  
  445.      9) Quotes.  The foot and inch marks (' ") are poor substitutes for typographical (curly) quotes, however they are all that most BBSs understand.  Use this popup menu to replace all ordinary quote marks with typographer quote marks and vice versa.
  446.  
  447.      10) Ligatrs.  The two available choices allow you to replace all occurrences of “fi” and “fl” with the single-character typographer ligatures or vice versa.  Note that some fonts do not have these ligatures installed, thus producing empty little boxes.  As with the smart quotes, ligatures are usually not recognized by less intelligent computer systems.
  448.  
  449.      11) Ellipses.  This popup menu presents two choices, allowing you to replace all ordinary ellipses (three consecutive periods) with a typographic ellipsis character or vice versa.
  450.  
  451.      12) Dashes.  This popup menu presents two choices, allowing you to replace all ordinary twin dashes with a typographic em dash character or vice versa.
  452.  
  453.      13) Line Endings.  These various choices allow you to easily convert BBS or MS-DOS line formatting to Mac line formatting and vice versa.  (See the section: “MS-DOS versus the Mac” above.)
  454.  
  455. Use Strip CR/LF to convert downloaded text to Mac-formatted word wrapping text.  If this does not seem to “work” right, undo the modifications and try it again with Strip leading spaces checked (above).
  456.  
  457. In an effort to maintain proper paragraph separation, the Strip commands ignore all CR-CR, CR-tab and CR-space character pairs.  You can also adjust the Min line length to preserve proper formatting for most tabular or blocked data (e.g. an address).  A typical setting of 40 characters will ignore CRs on lines less than 40 characters in length.
  458.  
  459. If you wish to format text for upload to a BBS or non-Mac computer, use the Add CR/LF option and set the Max line length to about 60-80 characters (which easily fits on most on-line editors).
  460.  
  461.      14) Reset.  Use this shortcut to turn off all the selected modifications at once (resetting them to their default values).
  462.  
  463. Go To Line #…
  464. If you are working with source code or a line-numbered legal document, use this command to jump to any specified line in the document.
  465.  
  466.      
  467.  
  468.      Figure 15.  Instantly select any line in the document.
  469.  
  470. This option is most helpful if you use the “Wide Open” text wrapping width (Preferences dialog).
  471.  
  472. Word Count…
  473. It is sometimes helpful to know exactly how long your book report is so far.  This command shows the word count, line count, character count, sentence count and paragraph count for the entire active document as well as the current selection.  The page count is an estimate based on the current paper size selected in the Page Setup dialog.  The character count is also continuously displayed in the lower left corner of each window, followed by the number of characters currently selected (hilited). 
  474.  
  475. Word Services
  476. Would you like to integrate a spelling checker (such as Spellswell Plus) into Tex-Edit?  Use this submenu to add or delete any Word Services program (“service”).  The services show up as menu items at the bottom of the submenu.
  477.  
  478. To add a service, you much first launch the desired service in the Finder.  Then select the Get New Service command and choose the desired service from the dialog.  Now, whenever you wish to use the service, simply select it from the Word Services menu.  To remove a service, use the Remove Service command.
  479.  
  480.  
  481.  
  482. Font Menu
  483.  
  484. The font menu lists all the fonts available to Tex-Edit Plus.  The current selection’s font is checked.
  485.  
  486. If you have OS 8 or newer, you can use the “Display typefaces in font menu” option in the Preferences dialog to show actual samples of the various fonts in the menu (WYSIWYG).  This option can cause a noticeable delay if you have many fonts installed and little memory.
  487.  
  488.  
  489.  
  490. Size Menu
  491.  
  492. The size menu lists a selection of common font sizes.  The current selection’s font size is checked.
  493.  
  494. Smaller
  495. This decrements the current selection’s font size by one point.  If the selection contains varying text sizes, then each of the various text sizes is reduced by one.  The command keys are a useful shortcut for easily adjusting font size.
  496.  
  497. Larger
  498. This increments the current selection’s font size by one point.
  499.  
  500. Other(_)…
  501. If you wish to change quickly to an odd font size, use this command to select any point size between 1 and 256.  Simply enter the desired value in the font size box (or use the arrow buttons).
  502.  
  503.      
  504.  
  505.      Figure 16.  A text sample is displayed at the given size.
  506.  
  507. The sample text is redrawn as its size changes.
  508.  
  509.  
  510.  
  511. Style Menu
  512.  
  513. Use the Style options to add a splash of color or emphasize important points.  If you have a color-compatible Mac, then the standard color picker dialog is available in the Color submenu.
  514.  
  515. Justification
  516. The Justification submenu may be useful for centering text on announcements or if you are using a right-to-left language script.  The justification setting affects how the document is displayed and printed, but does not alter the file’s contents.
  517.  
  518. Full justification will flush-align both the left and right margins in the display and the printout.  Default justification will set document alignment to match your system’s usual convention.  Left justification (default Roman) is recommended for fastest performance and is required for use of real tab spacing.
  519.  
  520. Text Width
  521. To allow your text to automatically word-wrap to fit between the left and right sides of any size window (like SimpleText), select Soft Wrap from the Text Width submenu.  This deactivates the horizontal scrollbar and may cause a delay when resizing windows containing a large amount of text.
  522.  
  523. The Small, Medium and Large presets allow you to set the line width to exactly 60, 80 and 100 characters (9 point Monaco).  If you are writing source code and want each entry to stay on a separate line, select the Wide Open option.  The Page Setup Size option will wrap the text to the page width specified in the Page Setup dialog, giving you a better idea how the printout will look.
  524.  
  525. The text width setting is saved with each document.
  526.  
  527. Auto Indent
  528. Are you creating source code for your latest program?  This option automatically indents each new line of text when you hit return.  Tabs and spaces are added to the beginning of the new line so that it matches the indent of the previous line.
  529.  
  530. Use Real Tabs
  531. If you would like to use tabs to create columns and indents, select this option.  It will enable tab spacing in the active document.  The tab stops can be set in the Tab Options dialog.  Turning this option on will force the document to be left-aligned while turning this option off will speed up file loading and window re-sizing.  The state of this switch is saved with each document.
  532.  
  533. Tab Options…
  534. This dialog allows you to fine tune tab handling in your documents.
  535.  
  536.      
  537.  
  538.      Figure 17.  New documents will open with tab stops already visible.
  539.  
  540.      1) Tab keypress will insert ___ spaces.  If you wish to create tab-like text alignment, but the recipient computer/software is possibly not tab-aware, select this option.  With this option activated, pressing the tab key will result in the insertion of the chosen number of spaces (instead of a tab) into the text.
  541.  
  542.      2) Real tabs on by default.  If you want to easily line up columns of numbers or indent the first line of each paragraph, turn this option on.  New or generic documents will open with Use Real Tabs enabled.  Tabs are only displayed when a document is left-aligned.
  543.  
  544.      3) Space (in points) between tabs:___  Tab stops (for real tabs) are equally distributed across the document with inter-tab spacing based on the number of pixels (1-120) you specify.  Tex-Edit runs fastest when this value is a multiple of 16 (16, 32, 48, etc.).
  545.  
  546. Show Invisibles
  547. If you are having trouble figuring out why the text is wrapped, spaced and indented the way it is, it may help to see the location of invisible characters.  Select this option to display non-printing placeholders for the five common “white space” creators: returns, tabs, spaces, formfeeds (page breaks) and linefeeds.
  548.  
  549.  
  550.  
  551. Sound Menu
  552.  
  553. Read Entire Document
  554. This command is remarkably helpful for proofreading documents, catching grammatical errors that elude both spelling checkers and tired eyes.  It reads the entire active document aloud.  The reading can be canceled or paused at any time.
  555.  
  556. Read Starting At Cursor
  557. Use this command to begin reading at any arbitrary point in the document.
  558.  
  559. Read Selection
  560. If you only wish to listen to a specific passage of text, use this command to read the selected text.  The reading can be stopped or paused as desired.
  561.  
  562. Stop
  563. This command immediately stops the reading session and any sound that may be playing.
  564.  
  565. Pause/Resume
  566. This command temporarily pauses or restarts the reading session.
  567.  
  568. Turn Speech On/Off
  569. This command activates the Speech Manager.  It must be selected before any other speech-related commands are usable.  Turning speech off will immediately stop all speech and sound playback and release any memory allocated for the Speech Manager.  This switch setting is remembered between launches.
  570.  
  571. Speech Options…
  572. Want to try a different voice or listen to a document read at double-speed?  This dialog allows you to modify some of the Speech Manager’s speech characteristics.  The Voice pop-up menu lists all the currently available voices.  The Default selection will activate your system’s default voice (chosen in the Speech control panel).  Notice that the “pro” voices are listed separately from the ordinary voices.  Selecting a voice will adjust the Voice pitch, Speech rate and Modulation to that voice’s default setting.
  573.  
  574. 
  575.  
  576.      Figure 18.  Radical alterations of voice characteristics are easy.
  577.  
  578. Try experimenting with different rates and pitches to get the most pleasing results.  The Sample button will cause a sample sentence to be read aloud.
  579.  
  580. Auto-Highlighting
  581. Would you like to sit back and watch what is being read while Tex-Edit Plus proofreads your document?  Choose By Word or By Sentence from this menu to have Tex-Edit Plus scroll each word/sentence into view and hilite it as it is read aloud.  Background editing functions are disabled while auto-highlighting is active.  This menu setting is remembered between Tex-Edit sessions.
  582.  
  583. Record Sound…
  584. If you’d really like to “wake up” recipients of your document, try inserting an audible note!  This command displays the standard sound input dialog for microphone-equipped Macs.  Once you finish recording the desired sound, it is inserted at the current selection.
  585.  
  586.      
  587.  
  588.      Figure 19.  Six seconds (out of the available 27) have been recorded.
  589.  
  590. Sounds show up as distinctive icons which can be cut, copied, pasted, deleted, dragged and dropped (even to the desktop).
  591. To play a sound, simply double click it.  Try this one:     
  592.  
  593. Insert Sound…
  594. Would you like to be able to “pull” the sounds out of other applications and documents and use them for your own purposes (copyright laws permitting)?  This command will display a standard dialog listing all sound-containing files.  Choose a file and all of its sounds will be inserted sequentially into your document.
  595.  
  596.  
  597.  
  598. Windows Menu
  599.  
  600. All open documents are readily available using the Windows menu.  Choose the document you wish to activate (bring to the front).  The currently active window is checked.
  601.  
  602. Switch
  603. Having trouble juggling several documents at once?  Use this command repeatedly to “cycle” through all open documents.
  604.  
  605.  
  606.  
  607. Scripts Menu 
  608.  
  609. If you’ve read all the way down to here and still don’t see a command that suits your needs, perhaps you need to create your own!  It’s easy.  (See the accompanying “WTHI AppleScript?” document or visit Doug Adams’ AppleScripts for Tex-Edit Archive web site: <http://www.malcolmadams.com/te/> )
  610.  
  611. The Scripts menu contains all of the compiled scripts that were present in the “Scripts” folder when Tex-Edit launched.  The Scripts folder must be named “Scripts” and reside in the same folder as the Tex-Edit application itself.  If the Scripts menu does not appear, you may need to install AppleScript.  (AppleScript is installed automatically if you have System 7.5 or newer.)
  612.  
  613. To create a command-key shortcut for your favorite script, add backslash-something (e.g., “ScriptName\0”) to the end of the script’s name.  The trailing character is used to create a keyboard shortcut for that command.  To create a command-shift-key shortcut, use two backslashes (“ScriptName\\0”).  To create a function key shortcut, append the name of the function key (F5-F15) to the backslash (“ScriptName\F12”).  Just be sure not to pick a shortcut which is already in use.
  614.  
  615. Edit Script
  616. If the script doesn’t do what you want, hold down the option key when selecting it from this menu.  This will launch the Script Editor program, allowing you to tinker with the script to your heart’s content.
  617.  
  618.  
  619.  
  620. Miscellaneous
  621.  
  622. Window Ornaments
  623. Do you need to keep close track of your document’s size?  The numbers at the bottom left corner of each text window conveniently display the character (byte) count followed by the character count in the current selection.
  624.  
  625. Did you forget the key combination for the “©” symbol?  Use the little ASCII popup menu  at the bottom left corner of the window to enter any character with a single mouse click.  Also, if you select a single character in your text, the popup menu will display its ASCII code and its position in the ASCII chart. 
  626.  
  627. Command Clicking of URLs
  628. The Internet Config extension will allow you to go to any location on the Internet by simply command-clicking on its URL from within Tex-Edit.  Most URLs are bracketed (<example>) for easy identification.  Try this one: <http://members.aol.com/tombb/>  The Internet Config archive is available at various locations, including: <http://www.quinn.echidna.id.au/Quinn/Config/>
  629.  
  630. Replacing SimpleText
  631. If you want Tex-Edit to open instead of SimpleText when you double click on a SimpleText document, you should first delete all copies of SimpleText and TeachText.  Then open the Mac Easy Open control panel and uncheck the “Always show dialog box” and “Include applications on servers” check boxes, and check the “Auto pick if only 1 choice” check box.  Then, click on Delete Preferences.
  632.  
  633. Next, create a startup set in Extensions Manager, with only Macintosh Easy Open active.  Restart while holding down the Command and Option keys to rebuild the desktop.  Restore your normal startup set in Extensions Manager, then restart again.  Finally, double-click on a SimpleText document to bring up a dialog box that lets you choose Tex-Edit Plus as the substitute application.
  634.  
  635. An elegant shareware solution to this dilemma also exists in the form of Marco Piovanelli’s Default App control panel.  It is available at: <http://www.merzwaren.com/da/>
  636.  
  637. Helpful Hints
  638. Here are some simple hints and tricks to increase Tex-Edit’s usefulness:
  639.  
  640. •  The watch cursor will spin during any time-consuming, interruptible operations.
  641.     Use command-period to interrupt the operation.
  642. •  Hold the option key down to edit any item in the Scripts menu.
  643. •  To edit the text in a TeachText, SimpleText or Tex-Edit read-only (ttro) document,
  644.     open a new blank window and use the Insert command—or simply select and copy the
  645.     entire document.
  646. •  Open any file by dragging it onto Tex-Edit Plus or its alias.  (See “Limitations” below.)
  647. •  Insert any number of text documents by simply dragging the document(s) onto an open
  648.     Tex-Edit Plus window.
  649. •  To move a styled Tex-Edit Plus document into another word processor without losing
  650.     style information, use the clipboard to copy and paste the entire document.
  651. •  Triple click to select a line.
  652. •  Quadruple click to select a paragraph.
  653. •  Option-click on a close box to close all windows.
  654. •  To delete all occurrences of a string, use the Find/Replace dialog.  Just leave
  655.     the replace field blank and choose Replace All.
  656. •  Count the number of occurrences of any given string using the Find/Replace
  657.     dialog.  Enter a wild run placeholder in the Replace with box, then choose
  658.     Replace All and note the number of replacements.
  659. •  To see non-printing characters (tabs, CRs, etc.), use the ASCII fonts included with
  660.     this archive.  (The ASCII font will show up at the bottom of the Font menu.)
  661. •  Tex-Edit’s PICT handling abilities are handy when it comes to cropping screen
  662.     shots (Command-shift-3) for use in other programs (e.g., Word).  Just
  663.     click-and-drag a selection marquee and choose Copy.
  664. •  If you run out of memory during a PICT copy operation, try keeping the entire
  665.     selection marquee visible.
  666. •  If you start noticing slowdowns during editing operations, break your document
  667.     into “chapters” and use Tex-Edit’s convenient Windows menu along with its
  668.     ability to hyperlink between documents (Open Selection).
  669. •  If you notice a delay when opening or resizing large documents, make sure the
  670.     text is left justified and Use Real Tabs is off.
  671. •  In order to resize windows to any width (like in SimpleText), use the Soft Wrap
  672.     text wrapping width option (Preferences dialog).
  673. •  A SimpleText read-only document can be read aloud (if speech is turned on) by
  674.     choosing one of the Read… commands in the Sound menu.
  675. •  A document can be read in the background if Auto-Highlighting is off.  You may
  676.     use all of Tex-Edit’s normal editing functions during the reading session.
  677. •  If you wish to create longer sounds, simply increase Tex-Edit’s memory
  678.     allocation (in the Finder’s Get Info dialog).
  679. •  To create an emphasized, indented, centered block of text (such as used to quote
  680.     brief poetic passages in a larger document), use the Block Format command with
  681.     the Block header (Block Options) set to all spaces.
  682. •  To “nest” quoted text (make a quote of a quote), use the Block Options dialog
  683.      to increase the max line length a little before issuing the Block Quote command.
  684. •  To avoid misaligned columns and indents in printouts, leave “Font Substitution” off
  685.     (in the Page Setup dialog) or use real tabs instead of spaces.
  686. •  All numeric dialog fields have up/down arrow buttons that allow quick adjustment
  687.     between allowable field values.
  688. •  Tex-Edit Plus is a “fat” binary program meaning that it runs at full native
  689.     speed on both the PowerMac and the 680x0 Mac.  If you are really strapped for
  690.     disk space, you can reduce Tex-Edit’s program size by about 50% using a program
  691.     such as FatFree or Strip.  This permanently removes the unused PPC or 68K code
  692.     from the application file.  It does not affect program speed or RAM usage in any way.
  693.  
  694. Keyboard Shortcuts
  695. Tex-Edit Plus makes full use of Apple’s extended keyboard including the forward delete, home, end, page up, page down and cursor keys.  The F1-F4 keys invoke the standard undo, cut, copy and paste commands.
  696.  
  697. Moving the cursor:
  698.  
  699. •  Option-left/right arrow moves the cursor one word at a time.
  700. •  Command-left/right arrow moves the cursor to the beginning/end of the line.
  701. •  Option-up/down arrow moves the cursor to the beginning/end of the page.
  702. •  Command-up/down arrow moves the cursor to the beginning/end of the document.
  703. •  Option-page up moves the cursor to the top of the previous screenful of text.
  704. •  Option-page down moves the cursor to the bottom of the next screenful of text.
  705.  
  706. Extending the selection:
  707.  
  708. •  Shift-arrow extends a selection.
  709. •  Shift-option-left/right arrow extends the selection one word at a time.
  710. •  Shift-command-left/right arrow extends the selection to the beginning/end of the line.
  711. •  Shift-option-up/down arrow extends the selection to the beginning/end of the page.
  712. •  Shift-command-up/down arrow extends the selection to the beginning/end of the document.
  713. •  Shift-option-page up extends the selection to the top of the previous screenful of text.
  714. •  Shift-option-page down extends the selection to the bottom of the next screenful of text.
  715.  
  716. Miscellaneous keyboard shortcuts:
  717.  
  718. •  Option-delete will delete the previous word.
  719. •  Option-forward delete will delete the next word.
  720. •  Enter/return will activate the default (outlined) button in dialogs.
  721. •  Esc/command-period will activate the Cancel button in dialogs.
  722. •  All other pushbuttons have command key equivalents based on the first letter in the
  723.     name of the button.  (For example Command-d activates the Don’t Save button in
  724.     the “Save Changes?” dialog.)
  725. •  Command-period will also stop all sound playback, stop all speech and stop most
  726.     time-consuming operations.
  727. •  Command-up/down arrow will cycle through panels in the Preferences and Help dialogs.
  728.  
  729. Other Features
  730. Tex-Edit Plus is 32 bit clean, stationery aware, drag manager aware, System 7 compatible, color compatible, big screen compatible, 68040 cache compatible and PowerPC native.  (Tex-Edit Plus is a “fat binary” application, meaning it can run at full speed on either a PowerPC or 680x0 Mac.)  Balloon help is available.
  731.  
  732. Tex-Edit Plus has an extensive AppleScript Dictionary (“aete” resource) and supports the Required, Standard, Text and Word Services Apple Event suites.  It also supports many items from the Miscellaneous suite as well as a broad range of custom commands, classes and properties (Tex-Edit suite).  See the “WTHI AppleScript?” document for further details.
  733.  
  734. Requirements
  735. Tex-Edit Plus requires System 7.0 or better.  To use the speech facility, you need Apple’s new Speech Manager extension.  (The old MacinTalk no longer works.)  To use the Drag & Drop function, you will need to use System 7.5 or place the Macintosh Drag and Drop extension in the Extensions folder.  (See the “Drag & Drop Spoken Here” chapter for more details.)
  736.  
  737. To use the AppleScript and the Scripts menu, you will need to install AppleScript.  (AppleScript is already installed if you have System 7.5 or better.)
  738.  
  739. Limitations
  740. Tex-Edit Plus is made to handle files of unlimited size, although slowdowns will become noticeable when files exceed 500-1000K, depending on your computer’s processor speed.  This compromise benefits PowerBook owners by keeping the entire document in RAM and minimizing disk accesses.
  741.  
  742. In unusual circumstances, it is possible to create a document that is so stylistically complex (many changes in font, size, style, color, etc.) that the text styles will be lost when the document is reopened.  Normally, the speed problems associated with large, complex files will intervene long before this style limit is reached.  If you need to create huge documents with many different styles, it is wise to break the document into manageable chunks.
  743.  
  744. To maximize its utility, I have given Tex-Edit Plus the ability to read the data fork of any file that it is forced to open (via a Finder drop or the Open Any command).  It is unwise to try to open an application file, especially if it is running.  (“Doc, it hurts when I do this…”)  Never try to open a System file.
  745.  
  746. Likewise, do not try to insert a sound from an open application or System file.
  747.  
  748. When opening SimpleText read-only documents, Tex-Edit converts all of the original picture resources into real picture objects (which can be moved, copied, etc.).  As a result, the pictures will no longer be automatically centered on the page when viewed in Tex-Edit.  Instead they will be positioned in accordance with your text’s Justification setting.
  749.  
  750. About The Speech Manager
  751. The Speech Manager extension and the MacinTalk Pro extension should be placed in the Extensions folder.  All voice files should be placed in a folder named “Voices” in the Extensions folder.  The Speech Manager only requires 150K of RAM and will function on practically any Mac, while the higher quality MacinTalk Pro voices require a lot more memory and processing power (700-2800K and 68020+).  Tex-Edit Plus runs fine without the Speech Manager.  The latest versions of the Speech Manager are distributed under the name “PlainTalk” in the form of a standard Apple Installer archive.
  752.  
  753. You can acquire the Speech Manager directly from Apple or from Quality Computers (1-800-777-3642).  Quality Computers sells a low-priced package that includes a fascinating group of speech-related programs and utilities.
  754.  
  755. Trouble Shooting
  756. It is easy to use all of Tex-Edit’s memory allotment while manipulating large color pictures or large sounds.  If you see an “out of memory” message, try turning on Temporary memory (in the Preferences dialog).  If you still are running short on memory, try increasing Tex-Edit’s memory allocation in the Finder.  I would suggest at least 1200K if you plan on doing a lot of picture editing with a big color monitor.
  757.  
  758. If you have trouble with the speech functions, try increasing Tex-Edit’s memory allocation.  The “high quality” MacinTalk Pro voices use the most memory.  “Marvin” and “Fred” use the least.
  759.  
  760. If the speech functions still don’t work, or if you notice any other strange behavior while using Tex-Edit Plus, try deleting the “Tex-Edit+ Prefs” file in the Preferences folder.  The Prefs file will be rebuilt from scratch the next time you use Tex-Edit Plus.
  761.  
  762. Similarly, it may help to delete the “Finder Preferences” file.
  763.  
  764. Some general problems are caused by a corrupted “Desktop” file.  Try rebooting your computer with the option-command keys held down.  (This is good general monthly maintenance.)
  765.  
  766. Some other general problems are caused by Extension conflicts.  Try rebooting your computer with the shift key held down.  You can also try turning off Use real tabs, turning off Temporary memory and/or turning off Offscreen drawing in the Preferences dialog.  Lastly, try a “clean install” of your System.
  767.  
  768. Registration
  769. Tex-Edit Plus is Shareware ($10).  Payment may consist of an equivalent amount of foreign currency or stamps.  (I love collecting foreign stuff!)  My mailing address is:
  770.  
  771.           Tom Bender
  772.           5313 Beverly Drive
  773.           San Angelo, Texas 76904
  774.           USA
  775.  
  776. Please include your e-mail address, if possible, so I can send you a message acknowledging your registration.  If you would like a printed receipt, please send me a stamped, self-addressed envelope.
  777.  
  778. Registered owners are entitled to all updates, source code and product support.  Registered users of previous versions of Tex-Edit are entitled to ownership of Tex-Edit Plus, of course.  (Thank you for your support!)
  779.  
  780. Feel free to give Tex-Edit Plus (with this document) to anyone.  You may use Tex-Edit Plus for as long as you wish (i.e., there is no time limit on the trial period).  You are under no moral obligation to send in the Shareware fee and you are under no obligation to erase the program if you don’t pay the fee.  Simply think of the Shareware fee as a much-appreciated way to encourage future development and to say “thank you!”
  781.  
  782. Source Code
  783. Registered owners may obtain a copy of the Metrowerks CodeWarrior Pascal source code (for personal use) by sending a disk and a self-addressed stamped disk mailer envelope to the mailing address given above.  Alternatively, I can transmit the source code via the Internet, if that is more convenient for you.  The source code is well-documented and may be helpful for other amateur programmers.
  784.  
  785. Product Support
  786. If you have questions, suggestions or bug reports, you may send a letter to the above address.  For a faster, more convenient response, you can reach me via modem:
  787.  
  788.           America Online:  TomBB
  789.           Internet:  tombb@aol.com
  790.          <mailto:tombb@aol.com>
  791.  
  792. I will keep the latest version of Tex-Edit Plus posted at my web or ftp site:
  793.  
  794.          <http://members.aol.com/tombb/>
  795.          <ftp://members.aol.com/tombb/>
  796.  
  797. The latest version is also routinely posted on Info-Mac and America Online.
  798.  
  799. Other Products
  800. Please also try Eliza (clinical psychologist), Re-Pete (memory game) and Azile (Eliza’s evil twin)!  I will continue to support Tex-Edit 2.x, which is System 6-compatible and limited to 32K files.
  801.  
  802. Credits
  803. I am grateful to the many users who have contributed to the evolution of Tex-Edit Plus, however I would especially like to thank E.J. Chichilnisky (for suggestions, feature development and extensive beta testing), Ramon Felciano (for development of the Mercutio MDEF, the power behind many of Tex-Edit's menu tricks), Martin Kimeldorf (for extensive help with the manual), Christopher Li (for localization and testing of the Japanese version of Tex-Edit Plus), Jean-Pierre Kuypers (for localization and testing of the French version of Tex-Edit Plus), Marco Piovanelli (for help with the code as well as development of the excellent WASTE text engine that allows large file handling), Michael Rohde (for the cool splash screen) and Ryan Schmidt (for bug detection and various suggestions).
  804.  
  805. Many thanks to Guy Kawasaki for his kind support and for letting the world know how great the Mac is!  To subscribe to Guy’s ultra-popular EvangeList, send email to: <mailto:evangelist@macway.com>
  806.  
  807. Many thanks to Doug Adams for creating and maintaining the excellent AppleScripts for Tex-Edit Archive web site: <http://www.malcolmadams.com/te/>
  808.  
  809. Many thanks also to Bob LeVitus and Christopher Breen for their encouraging words and for letting folks know how to substitute Tex-Edit for SimpleText (MacUser 3/97).
  810.  
  811. Lastly, I wish to thank my loving Paula for putting up with me (and for occasionally allowing me to borrow her PowerBook).
  812.  
  813.  Tex-Edit Plus is copyright ©1994-1998 by Tom Bender.  All rights reserved.  WASTE text engine is copyright ©1993-1998 by Marco Piovanelli.  Mercutio MDEF is copyright ©1992-1998 Ramon M. Felciano.  Document revised 8/4/98.